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(5 Cortland Miscellaneous Tools 

July 16,1986 

Written by Ray Montague & Eagle Born 

Revision History. 

March 10,1986 Ver. 0.81 R. Montagne Major revisions to the Miscellaneous Tool Set have oceured. 

The Integer Math functions have been removed, and now comprise the 
INTEGER MATH TOOL SET. The Pascal and Basic I/O functions 
have also been removed, and are now found in the TEXT TOOL SET. 
A stack pointer indicator (sp—>) has been added to the parameter lists 
for clarity. Basic functionality of most tool functions remaining in 
the MISCELLANEOUS TOOL SET has not changed. However, all 
of the function numbers have changed. Many of the functional 
descriptions have been rewritten for clarity. Functions that have 
changed are: (1) INTERRUPT CONTROL TOOLS 

(2) FIRMWARE FLAG TOOLS 

(3) INTERRUPT ENABLE STATUS TOOLS 

March 12,1986 Ver. 0.82 R. Montagne System Death Manager. Additional information on interrupts source 

control (Keyboard interrupts). Additional information on the 
environment when using Firmware Entry. Additional information on 
installing ROM based tasks into the HeartBeat queue. 

April 18, 1986 Ver. 0.83 R. Montagne ID Manager Type 8. System Death Error Codes. Additional Vectors. 

April 23, 1986 Vs-. 0.84 R. Montagne Added vectors for STEP and TRACE. Additional parameters in the 

GET ADDRESS function. This is the BETA 2.0 Implementation. 

April 29, 1986 Ver. 0.83 R. Montagne Added functions to set and get damps fat absolute devices. Mouse 

calls will return an error if the card is not switched in rather than call 
the system death manager. 

May 9,1986 Ver. 0.86 R. Montagne ID Manager ID assignments. Read ASCII time (state of MSB). 

Set/Get Vectors. 

June 11,1986 Ver. 0.87 R. Montagne Added SETUP FILE ID to ID Manager. 

June 26,1986 Ver. 0.88 R. Montagne No functional change, just added examples. 

July 9, 1986 Ver. 0.89 Montagne/Bems Added SCRAP MANAGER ID tag. Eagle's Examples!! 

System Death Syntax. System Death messages and Language 
Card. More descriptive death codes. Stack example in MUNGER 
was corrected. 


July 16, 1986 Ver. 0.90 Montagne 


Corrected tool number in death codes. 
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Miscellaneous Tools. So far the tools we have specified fall into broad catagories and each 
deserve their own tool set Unfortunately, ther are a number of routines in the firmware that do not 
fall into any of these categories but still must be accessed from native mode. These routines 
include: 

APPLE] [ entry points Mouse support ' Clock support 

Battery ram support Interrupt support ID Tag managment 

VBL or HeartBeat managment System Death managment 

Standard Tool Set Calls. 

MTBootMt Function number - $01 

This tool call clears the TiekCounter and the HeartBeat task link pointer. It 
also sets the Mouse flag to 'NOT FOUND’. A block of memory with a 
length of NIL is requested from the memory manager for use by the ID tag 
manager. 

Example: 

jvfTBOOTO'jrr 


MTStartUp Function number = $02 
This does nothing. 

Example: 

„MTSTARTUP 


MTShutDown Function number * $03 

This does nothing. 

Example: 

„MTSHUTDOWN 


MTVersion 

Function number = $04 

Input 

Sp— rai, > 

Word 

Space for result 

Output 

Word 

Version number 

sp—> 




This tool returns the version number of the Miscellaneous Tool Set. 


Example: 

PEA $0000 ; SPACE FOR RESULT 

_MTBOOTTNIT 
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MTReset Function number = $05 

This tool call clears the HeartBeat queue link pointer and sets the Mouse flag 
to 'NOT FOUND*. 

Example: 

J4TRESET 


MTStatus 

Function number 3 $06 

Input 

sp—> 

Word 

Space for result 

Output 

Word 

Status ($0000=lnactive, $FFFF=Acnve) 

sp—~> 




This tool returns a status that indicates that the Miscellaneous Tool Set is 
active. 

Example: 

PEA $0000 ; SPACE FOR RESULT 

JvfTSTATUS 


MTSpare 1 Function number = $07 

This does nothing. 

Example: 

„MTSPARE1 


MTSpare2 Function number 3 $08 

This does nothing. 

Example: 

„MTSPARE2 
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Battery Ram Tools. These routines allow the non volatile battery backed up ram to be read 
written. 

WriteBRam Function number * $09 

Input LongWord Buffer Address 

sp—> 

The 252 bytes of data at the memory location specified by the Buffer 
Address plus four bytes of checksum data is written to the battery ram. 

Example: 

PUSHLONG #LABEL ; BUFFER ADDRESS 
_WRTTEBRAM 


ReadBRam Function number = $0A 

Input LongWord Buffer Address 

sp—> 

The 252 bytes of data plus four bytes of checksum data is read from the 
battery ram and stored at the memory location specified by the Buffer 
Address. 



_READBRAM 


WriteBParam Function number = $0B 

Input Word Data (low byte only) 

Input Word Parameter Reference Number (0-255) 

sp—> 

Data is written to the battery ram location specified by the Parameter 
Reference Number. 

Example: 

PEA $0005 ; DATA IN LOW BYTE 

PEA $0028 ; REF - STARTUP SLOT 

^WRITEBPARAM 
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ReadB Parana 

Function number - $0C 

Input 

Input 

sp—> 

Word 

Word 

Space for result 

Parameter Reference Number (0-255) 

Output 

sp—> 

Word 

Data (low byte only) 

Example: 

PEA $0000 ; SPACE FOR RESULT 

PEA $0028 ; REF = STARTUP SLOT 

JREADBPARAM 


Data is read from the battery ram location specified by the Parameter 
Reference Number. 
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Battery Ram Parameter Reference Numbers: 

$00 Pott 1 Printer/Modem 

$01 Port 1 Line Length 

$02 Port 1 Delete line feed after carriage return 

$03 Port 1 Add line feed after carriage return 

$04 Port 1 Echo 

$05 Port 1 Buffer 

$06 Port 1 Baud 

$07 Pott 1 Data/Stop Bits 

$08 Port 1 Parity 

$09 Port 1 DCD Handshake 

$0A Port 1 DSR Handshake 

$0B Port 1 Xon / Xoff Handshake 

$0C Port 2 Printer/Modem 

$0D Port 2 Line Length 

$0E Port 2 Delete line feed after carriage return 

$0F Port 2 Add line feed after carriage return 

$10 Port 2 Echo 

$11 Port 2 Buffer 

$12 Port 2 Baud 

$13 Port 2 Data/Stop Bits 

$14 Port 2 Parity 

$15 Port 2 DCD Handshake 

$ 16 Port 2 DSR Handshake 

$17 Port 2 Xon / Xoff Handshake 

$ 18 Display Color / Monochrome 

$19 Display 40 / 80 column 

$1A Display Text Color 

$1B Display Background Color 

$ 1C Display Border Color 

$1D 50 / 60 Hertz 

$1E User Volume 

$1F Bell Volume 

$20 System Speed 

$21 Slot 1 Internal / External 

$22 Slot 2 Internal / External 

$23 Slot 3 Internal / External 

$24 Slot 4 Internal / External 

$25 Slot 5 Internal / External 

$26 Slot 6 Internal / External 

$27 Slot 7 Internal / External 

$28 Startup Slot 

$29 Text Display Language 

$2A Keyboard Language 

$2B Keyboard Buffering 

$2C Keyboard Repeat Speed 

$2D Keyboard Repeat Delay 

$2E Double Click Time 
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$2F Flash Rate 

$30 Shift Caps / Lower Case 

S31 Fast Space / Delete Keys 

$32 Dual Speed 

$33 High Mouse Resolution 

$34 Month / Day/Year Format 

$35 24 Hour / AM-PM Format 

$36 Minimum Ram for RAMDISK 

$37 Maximum Ram for RAMDISK 

$38-40 Count / Languages 

$41-51 Count / Layouts 

$52-7F Reserved 

$80 AppleTalk Node Number 

$81-A1 Operating system variables 

$A2-FB Reserved 

$FC-FF Checksum 
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Clock Tools. These routines allow the clock to be set or read. Setting the clock requires that the 
tim e be passed as an input paramter in a hex format Two tools are provided for reading the clod. 
One returns time in a hex format, while the other returns time in an ASCII format. 

ReadTimeHex Function number = SOD 

Space for result 
Space for result 
Space for result 
Space for result 


Output Byte 

Output Byte 

Output Byte 

Output Byte 

Output Byte 

Output Byte 

Output Byte 

Output Byte 

sp—> 

Returns current time in Hex format 




Example: 


PEA 

$0000 

; SPACE FOR RESULT 

PEA 

$0000 

; SPACE FOR RESULT 

PEA 

$0000 

; SPACE FOR RESULT 

PEA 

$0000 

;SPACE FOR RESULT 
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ReadAsdfllme Function number = $0F 

Input LongWord ASCII buffer address 


Reads elapsed time since January 1,00:00:00 1904, and converts to ASCII 
time output which is placed in the applications buffer. Note that ASCII time 
always outputs twenty characters with the MSB of each character set to a 
one. ASCn time format is defined by the format set up in the battery ram 
by the control panel. Format versus the battery ram parameter value is 
shown below: 


o 

1 

2 
0 
1 

2 


Time Format 

0 

0 

0 

1 

1 

1 


ASQLTmeJEormat 
mm/dd/yy HH:MM:SS AM or PM 
dd/mm/yy HH:MM:SS AM or PM 
yy/mm/dd HKMMiSS AM or PM 
mm/dd/yy HH;MM:SS 
dd/mm/yy HH:MM:SS 
yy/mm/dd HH:MM:SS 


HH - Hour 


MM, * Minute 
SS « Second 
mm » Month 
ddasDay 


Where: 
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Vector Initialization Tools. These tools allow the application to set or get the current vector 
for the interrupt handlers. 

SetVector Function number = $10 

Input Word Vector Reference Number 

Input LongWord Address 

sp—> 

Sets the vector address for the interrupt manager or handler specified by the 
vecotr reference number. 

Example: 

PEA $000E ; REF. = 1/4 SEC IRQ 

, PUSHLONG #LABEL ; HANDLER ADDRESS 



^SETVECTOR 


GetVector 

Function number * $ 11 

Input 

Input 

sp—> 

LongWord 

Word 

Space for result 

Vector Reference Number 

Output 

sp—> 

LongWord 

Address 


Returns with the vector address for the interrupt manager or handler 
specified by the vector reference number. 

Example: 

PEA $0000 ; SPACE FOR RESULT 

PEA $0000 

PEA $0015 ; REF. = 1 SEC. IRQ 

J3ETVECTOR 
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Vector Reference N um bers: 

$0000 Tool Locator #1 

$0001 Tool Locator #2 

$0002 User’s Tool Locator #1 

$0003 User’s Tool Locator #2 

$0004 Interrupt Manager 

$0005 COP Manager 

$0006 Abort Manager 

$0007 System Death Manage 

$0008 AppleTalk Interrupt Handler 

$0009 Senal Communications ConooUer Interrupt Handler 

$O00A Scan Line Interrupt Handler 

5000B Sound Interrupt Handler 

$000C Vertical Blanking Interrupt Handle* 

SOOOD Mouse Interrupt Handler 

$000E Quarter Second Interrupt Handler 

$G00F Keyboard Interrupt Handler 

$0010 Front Desk Bus Response Byte Interrupt Handler 

$0011 Front Desk Bus SRQ Interrupt Handler 

$0012 Desk Accessory Manager 

$0013 Flush Buffer Handler 

$0014 Keyboard Micro Interrupt Handler 

$0015 One Second Interrupt Handler 

$0016 External VGC Interrupt Handler 

$0017 Other Unspecified Interrupt Handler 

$0018 Cursor Update Handler 

$0019 Increment Busy Flag (for Scheduler) 

S001A Decrement Busy Flag (for Scheduler) 

$001B Bell Vector (for Sound Tools) 

$001C Break Vector (for Debuggers) 

S001D Trace Vector 

$00 IE Step Vector 

$00IF Reserved Vector 

$0020 Reserved Vector 

$0021 Reserved Vector 

$0022 Reserved Vector 

$0023 Reserved Vector 

$0024 Reserved Vector 

$0025 Resaved Vector 

$0026 Reserved Vector 

$0027 Reserved Vector 

$0028 Control Y Vector 

$0029 Reserved Vector 

S002A ProDOS'16 MU Vector 

$002B OS Vector 

S002C Message Pointer Vector 


u 
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HeartBeat Tools. These tools allow the application to insert or delete tasks from the HeartBeat 
queue. 

SetHeartBeat Function number = $12 

Input LongWord Pointer 

sp—*> 


Installs the task specified by the pointer into the HeartBeat queue. The 
pointer must be set to the address of a task header that precedes the task. 
The task header area consists of a longwoid link pointer, count word, and 
signature word. The link pointer is maintained by the tool, and is set to a 
value of $00000000 if the task is the last task in the queue. When a task is 
installed, the link pointer of the previous task is set to point at the task 
header for the task currently being installed. The count word is set by the 
application prior to installing the task, and must be maintained by either the 
task or the application. The count word indicates the number of VBL 
interrupts that must occur before the associated task is executed. For 
recurring tasks, the task should reset the count word. For tasks that are run 
as a software one-shot, the application should reset the count word. The 
tool will decrement a non zero count word each VBL interrupt If the 
decrement results in a count word of zero, the task will be executed. A 
count word with a value of zero win not be decremented during VBL 
interrupt, and effectively sets the task inactive until a non zero value is 
stored to the count word. Tasks are executed in native mode with 8 bit'm' 
and 'x'. Task execution should terminate with an 'RTL' instruction. The 
signature word must be set prior to installing a task, and is used by the tool 
and the HeartBeat Interrupt Handler to check the integrity of the HeartBeat 
queue. An example of a HeartBeat task that increments a location in 
memory everty tenth VBL is shown below: 


TasklHdr 

Stan 

(Jq 0 OOOOOOO 

4i’0' 

; Space for Link Pointer 

TasklCnt 

dc oooy 

2i’10' 

; Count word preset to 10 


dc 

h,'5AA5' 

; Signature Word $A55A 

Taskl 

anop 




rep 

#$20 

; 16 bit'm' 


longa 

on 



phk 


; data bank = program bank 


plb 



Ida 

#10 

; reset the task count 


sta 

TasklCnt 



sep 

#$20 

; 8 bit'm' 


longa 

off 



Ida 

>TestLoc 

; and increment an address 


inc 

a 



sta 

>TestLoc 



rtl 



The following code will install the task shown above. 

Install 

anop 

PUSHLONG 

#LABEL 

; BUFFER ADDRESS 


^SETHEARTBEAT 

; INSTALL TASK 


J 
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Note that when a task is installed into the HeartBeat queue, the HeartBeat 
Interrupt Handler win automatically be installed into the VBL Interrupt 
Handler vector. Any handler previously installed in the VBL Interrupt 
Handler vector will be displaced. Installing a task in the HeartBeat queue 
does not automatically enable VBL interrupts . It is left to the application to 
enable VBL interrupts. Also, since tasks are linked with simple pointers, 
the tasks should reside in LOCKED' memory. Tasks that make use of 
system resources should conform to the protocol set down in the 
SCHEDULER ERS. 


It may be desirable to have a ROM based task executing from a peripheral 
card. In order to install a ROM based task, twelve bytes of ram must be 
allocated for use by the task header, with the task executing a jump absolute 
long to the rom based task. An example of this is shown below: 


TasklHdr dc 
TasklCnt dc 
TasklSig dc 
TasklJmp anop 
jmp 


4i'0’ ; Space for Link Pointer 

2i*10* ; Count word preset to 10 

h,'5AA5’ ; Signature Word $A55A 


>RomTaskl ; jump to ROM based task 


An example that shows how a program can consauet the task header area in 
RAM for a ROM based task is shown below. Note that this program is run 
in full native mode (16 bit'm' and 'x'). 


InstallTl 


entry 


Ida 

#$0001 

sta 

>TasklCnt 

Ida 

#$A55A 

sta 

>TasklSig 

Ida 

#RomTaskl 

pha 


xba 


and 

#$FF00 

ora 

#$005C 

sta 

>TasklJmp 

pla 


and 

#$FP00 

ora 

# A RomTaskl 

xba 


sta 

>TasklJmp+2 

PushLong 

SetHeartBeat 

#Label 


initialize task count 
initialize task signature 
now install 'JMP' to task 


; now install the task 


Errors that may occur when installing a task in the HeartBeat queue include: 

$0303 Task already installed in queue 
$0304 No signature in task header 

$0305 Queue has been damaged-task signature missing during search 
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Input LongWord Pointer 

sp—-> 

Deletes the task specified by the link address from the HeartBeat Interrupt 
service queue. 

Errors that may occur when deleting a task in the HeartBeat queue include: 

$0305 Queue has been damaged-task signature missing during search 
$0306 Task was not found in queue 

Example: 

PUSHLONG #LABEL ; TASK ADDRESS 
JDELHEARTBEAT 


QrHeartBeat Function number = $14 

Gears the HeartBeat queue root link pointer, affectively removing all tasks 
from the queue. 

Example: 

JXRHEARTBEAT 
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System Death Manager. This tool call jumps through the system death vector. At system 
power-up time, a default system death manager is installed into the system death manager vector. 
The default system death manager will display either a default system death message followed by 
an error code, or a user defined system death message followed by an error code. The default 
system death message will display a sliding Apple below a centered default message as shown 
below: 


FATAL SYSTEM ERROR-> XXXX 


__ ft 

If a system death call is made with a user defined message, the user defined message will be 
displayed starting at the upper left hand comer fo the screen. The user defined message may 
contain up to 254 characters. The text may be moved down by imbedding carriage return 
characters in the text Any desired delimiters between the text string and the error code Should be 
included in the text string. 

USER DEFINED MESSAGE OF UP TO 255 CHARACTERS XXXX 


__ ^ __ .. 

SysDeathMgr Function number = $15 

Input Word Error code 

Input LongWord Pointer 

sp—> 


If the longword pointer is set to zero, the default system death message and 
the error code passed as the tool input are displayed. If pointer is set to 
point to an ASCII string, the ASCII string will be displayed with the error 
code. The first byte of the ASCH string should contain a count equal to the 
number of characters to be displayed. The ASCII string should have the 
MSB turned off. Note that this tool call will not return! Death Messages 
cannot reside in the Language Card address space. 

Example: 

PEA $0004 ; YOUR ERROR CODE 

PUSHLONG #LABEL ; STRING POINTER 

^SYSDEATHMGR 
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$0001 ProDOS'16 - Unclaimed interrupt 
$0004 Divide by zero 

$000A ProDOS'16 - Volume Control Block unusable 

$0Q0B ProDOS’16 - File Control Block unusable 

SOOOC ProDOS'16 - Block zero allocated illegally 

$000D ProDOS'16 - Interrupt with I/O shadowing off 

$0015 Segment Loader error 

$0017-24 Can't load a package 

$0025 Out of memory 

$0026 Segment Loader error 

$0027 File map trashed 

$0028 Stack overflow error 

$0030 Please insert disk (file manager alert) 

$0032-53 Memory manager error 

$0100 Can't mount system startup volume 

System death error codes above $0100 will be tools specific. 
The high byte of the error code will contain the tool number 
reporting the error. The low byte of the error code is defined 
by the tool set reporting the error. No tool will report an error 
with the low byte set to a value of $00. 


DeathCode 

RclatcdToalSet 

$01XX 

Tool Locator 

S02XX 

Memory Manager 

S03XX 

Miscellaneous Tools 

$04XX 

QuickDraw 

$05XX 

Desk Manager 

S06XX 

Event Manager 

$07XX 

Scheduler 

$08XX 

Sound Manager 

$09XX 

Apple Desktop Bus Tools 

$0AXX 

SANE 

S0BXX 

Integer Math Tools 

SOCXX 

Text Tools 

$0DXX 

Ram Disk 

S0EXX 

Menu Manager 

$0FXX 

Window Manager 

$10XX 

Control Manager 

$11XX 

Loader 

$12XX 

Printer 1 

$13XX 

Printer 2 

$14XX 

Line Edit 

$15XX 

Pick Manager 

$16XX 

Dialog Manager 
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GET ADDRESS Tools. These tools are provide to allow an application to determine the 
address of a parameter used by the system firmware. 


GetAddr 

Function number = $16 

Input 

LongWord 

Space for result 

Input 

Word 

Reference number 

Output 

sp—> 

LongWord 

Pointer to parameter 


Parameter reference numbers and parameter size are defined below: 


ReL# 

$0000 

$0001 

$0002 

$0003 

$0004 

$0005 

$0006 

$0007 

$0008 

$0009 

SQOOA 

$0008 

$000C 

$0000 


LfflSh Earameter 

Byte IRQ Interrupt Flag (IRQ.INTFLAG) 

Byte IRQ Data Flag (IRQDATAREG) 

Byte IRQ Serial Port 1 Flag (IRQ.SERIAL1) 

Byte IRQ Serial Pon 2 Flag (IRQ.SERIAL2) 

Byte IRQ AppleTalk Flag (IRQ.APLTLKHI) 

LongWord Tick Counter (TICKCNT) 

Byte IRQ Volume (IRQ.VOLUME) 

Byte IRQ Active (IRQ-ACTIVE) 

Byte IRQ Sound Data (IRQ.SOUNDDATA) 

20 Bytes Variables after a 'BRK' (BRK.VAR) 

12 Bytes Event Manager Data (EVMGRDATA) 

Byte Mouse Locarion/Flag (MouseSlot) 

8 Bytes Mouse Clamps (MOUSECLAMPS) 

8 Bytes Absolute device clamps (ABSCLAMPS) 


Note that parameters with reference numbers from $0000 through $0004 
should not be used by applications. These parameters are only valid while 
servicing an interrupt 


Example: 

PEA $0000 ; SPACE FOR RESULT 

PEA $0000 

PEA $000C ; REF.» MOUSE CLAMPS 

jGETADDR 
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Further definition of some parameters is provided below: 

IRQ.INTFLAG D7 1 = Mouse button down 

D6 1 = Mouse button down on last read 

D5 Status of AN3 

D4 1 = 1/4 second interrupted 

D3 1 = VBL interrupted 

D2 1 = Mega// Mouse switch interrupted 

D1 1 = Mega// Mouse movement interrupted 

DO 1 = System IRQ line is asserted 


IRQDATAREG D7 
D6 
D5 
D4 
D3 
DO-2 


1 = Response byte, 0 = Status byte 
1 = Abort 

1 = Desktop manager sequence pressed 
1 = Flush buffer sequence pressed 
1« SRQ 

0 ® No FDB data, 0 # number of valid bytes -1 


BRK.VAR 


Word 
Word 
Word 
Word 
Word 
Byte 
By 
By 
By 
w< 

By 
By 
By 
By 


A Register 
X Register 
Y Register 
Stack Pointer 
Direct Register 
Processor Status 



CEEuEliaEEM 


LongWord Pointer to journal driver (JoumalPtr) 


MouseSlot Byte Location of the Mouse (MouseSlot) 

This is a flag used by the MouseTools. If 
MouseSlot contains a positive value, then it 
indicates what slot the mouse resides in. If 
MouseSlot contains a negative value, the 
Mouse has not been initialized by the Mouse 
Tools. 
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MouseClamps Word Low X axis mouse clamp 

Word Low Y axis mouse clamp 
Word High X axis mouse clamp 
Word High Y axis mouse clamp 
(Note that setting the mouse clamp values directly is not a viable method of 
setting the mouse clamps. Setting mouse clamps correcdy can only be 
guaranteed using the mouse tools.) 

AbsClamps Word Low X axis absolute device clamp 

Word Low Y axis absolute device clamp 

Word High X axis absolute device clamp 

Word High Y axis absolute device clamp 

(There is no built in firmware to clamp absolute device position within the 
absolute device clamp bounds. Absolute device drivers must be responsible 
for clamping position within the clamp bounds.) 
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Mouse Tools. These tools are provide to interface with the Mouse. These tools will work with 
both the built in Front Desk Bus Mouse or the Apple] [ Mouse. Note that the 'InitMouse' call must 
be executed first. An error will be returned if a dispatch to the mouse is executed with the mouse 
firmware switched out 


ReadMouse 

Function number = $17 

Input 

Word 

Space for result 

Input 

Word 

Space for result 

Input 

sp—> 

Word 

Space for result 

Output 

Byte 

High Byte X Position 

Output 

Byte 

Low Byte X Position 

Output 

Byte 

High Byte Y Position 

Output 

Byte 

Low Byte Y Position 

Output 

Byte 

Mouse Status 

Output 

sp—> 

Byte 

Mouse Mode 


Returns Mouse position, status and mode. 

Example: 

PEA $0000 ; SPACE FOR RESULT 

PEA $0000 

PEA $0000 

.READMOUSE 

InitMouse Function number = $18 

Input Word Mouse slot 

$0000 = Search slots for Mouse 
$0001-7 = Slot Mouse resides in 

sp—> 

Initializes the mouse clamp values to $0000 minim um! and $03FF 
maximum. Mouse mode and status are cleared. 

Example: 

PEA $0000 ; REQUEST SEARCH 

.INITMOUSE 
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SetMouse Function number » $19 

Input Word Mode (in low byte) 

sp—> 


Mode is set to new value as follows: 

$00 Turn off Mouse 

$01 Set transparent mode 

$03 Set movement interrupt mode 

$05 Set button interrupt mode 

$07 Set button or movement interrupt mode 

$08 Turn mouse off, VBL IRQ active 

$09 Set transparent mode, VBL IRQ active 

SOB Set movement interrupt mode, VBL IRQ active 

SOD Set button interrupt mode, VBL IRQ active 

$0F Set button or movement interrupt mode, VBL IRQ active 

Example: 

PEA $0001 ; TRANSPARENT MODE 

.SETMOUSE 


HomeMouse Function number = $1A 

Positions the Mouse at the minimum clamp position. 
Example: 

.HOMEMOUSE 


QearMouse Function number = $1B 

Sets both the X and Y axis position to $0000 if minimum clamps are 
negative (delta or reladve mode), or to the minimum clamp position if the 
chumps are positive (absolute mode). 

Example: 

.QEARMOUSE 
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QampMouse Function number = $ 1C 


Input Word 

Input Word 

Input Word 

Input Word 

§p_> 


X axis minimum clamp value 
X axis maximum clamp value 

Y axis minimum clamp value 

Y axis maximum clamp value 


Sets die clamp values to new values, and then sets the Mouse position to the 
roiminum clamp values. 


Example: 



PEA 

$0000 

X MINIMUM 


PEA 

$03FF 

X MAXIMUM 


PEA 

$0000 

YMIMMUM 


PEA 

S03FF 

Y MAXIMUM 


JXAMPMOUSE 


GetMousedamp 

Function number - $1D 


Input 

Word 

Space for result 


Input 

Word 

Space for result 


Input 

Word 

Space for result 


Input 

Word 

Space for result 


sp—> 




Output 

Word 

X axis minimum clamp value 

Output 

Word 

X axis maximum clamp value 

Output 

Word 

Y axis minimum clamp value 

Output 

Word 

Y axis maximum clamp value 


sp—> 


Returns the current values of the Mouse clamps. 

Example: 

PEA $0000 ; SPACE FOR RESULT 

PEA $0000 

PEA $0000 

PEA $0000 

J3ETMOUSECLAMP 
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PosMouse Function number = $1E 


Input Word X axis position 

Input Word Y axis posidon 

sp—> 


Posidons the Mouse to the coordinates specified. 


Example: 

PEA $013C ; X POSITION 

PEA $028F ; Y POSITION 

.POSMOUSE 


ServeMouse Function number = $XF 

Input Word Space for result 

sp—> 

Output Word Interrupt status (in low byte) 

sp—> 

Returns mouse interrupt status. 

Example: 

PEA $0000 ; SPACE FOR RESULT 

.SERVEMOUSE 
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ID Tag Manager. These tools are used to create, delete and inquire status of an ID Tag. The ID 
Tag is used to mark memory segments as belonging to a specific application or desk accessory. ID 
tags are made up of three fields encoded in a word parameter. These are the TYPE field, AUX ID 
field, and MAIN ID field. The type field is encoded in bits 12-14, Aux ID in bits 8-11, and the 
Main ID in bits 0-7. The AUX ID field is defined by the caller. The Main ID field is generated by 
the ID Tag manager. The ID Tag will always be assigned with a non zero value in the Main ID 
field. The Type field has fixed assignments as shown in the table below: 



2 * CONTROL PROGRAM 
3-ProDQS 

^TOOLKITS —^ S41XX ■ Mige®lka@on* Tools) 

3 » DESK ACCESSORIES ( S42XX - Scrap Manager) 

6 m RUN TIME LIBRARIES 

7= SYSTEM LOADER 
8 *> FIRMWARE / SYSTEM FUNCTION 
9-TOOL LOCATOR 
A » SETUP FILE 
B a UNDEFINED 
C» UNDEFINED 
D-UNDEFINED 
E> UNDEFINED 
F-UNDEFINED 


GetNewID 

Function 

number = $20 

Input 

Word 

Space for result 

Input 

sp—> 

Word 

ID Tag 

Output 

sp—> 

Word 

ID Tag 


Caller passes a full 16 bit ID tag as input with the TYPE defined as the only 
relevant parameter. The AUX ID field is specified by the caller, and will 
not be reassigned by the ID manager. The next available MAIN ID will be 
concatenated to the TYPE and AUX ID fields, and the resulting ID Tag will 
be returned to the caller. Note that the TYPE field must be non zero. Note 
that only 255 ID tags can be assigned for any TYPE ID. If an ID cannot be 
assigned because all the ID tags for that TYPE have been assigned, then an 
error will be returned indicating that the ID is not available. 

Example: 

PEA $0000 ; SPACE FOR RESULT 

PEA $5100 ; ITS A DESK ACC. 

_GETNEWID 
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Delete© Function number ~ $21 

Input Word © Tag 

S p__> 


The caller passes the tool a fun 16 bit © tag as input with the TYPE and 
MAIN © fields defined as the only relevant parameters. Any © tags with 
the same MAIN © and TYPE are deleted from the current © tag list. This 
tool call will not report an error if the tag is not found. It assumes that if its 
not there, that is what you wanted anyway. 

E xamp le: 

PEA $5101 ; DELETE DESK ACC TAG 

^DELETE© 


Status© Function number » $22 

Input Word © Tag 

sp—> 

The caller passes die tool a full 16 bit © tag as input with the TYPE and 
MAIN © fields defined as the only relevant parameters. If the © tag is 
active, no error will be returned. If the © tag is inactive, an error will be 
returned indicating that the © tag is not available. 

Example: 

PEA $5101 ; DELETE DESK ACC TAG 

.STATUS© 
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Interrupt Control Tools. This tool allows certain interrupt sources to be enabled or disabled. 


IntSouree Function number = $23 

Input Word Source Reference Number 

sp—> 

This tool call enables or disables the interrupt source specified by the source 
reference number. Source reference numbers are shown below: 


SsL# 

$0000 

$0001 

$0002 

$0003 

$0004 

$0005 

$0006 

$0007 

$0008 

$0009 

$000A 

S000B 



Enable Keyboard Interrupts 
Disable Keyboard Interrupts 
Enable VOTcal Blanking Interrupts 
Disable Vertical Blanking Interrupts 
Enable Quarter Second Interrupts 
Disable Quarto' Second Interrupts 
Enable One Second Interrupts 
Disable One Second Interrupts 
THIS DOES NOTHING 
THIS DOES NOTHING 
Enable FDB Data Interrupts 
Disable FDB Data Interrupts 


< r. HI i f V W 1» I ~9 1 ♦ 11 * i» \ •lK'l 


Disable Scan Line Interrupts 
Enable External VGC Intorupts 




Example: 

PEA $0002 ; ENABLE VBL IRQ 

JNTSOURCE 


ABOUT KEYBOARD INTERRUPTS_ 

When keyboard interrupts are enabled, there is no hardware enable of the 
keyboard interrupt The firmware installs a task into the HeartBeat queue 
and enables VBL interrupts. This causes the HeartBeat interrupt handler to 
be installed into the VBL interrupt vector. This task will check the status of 
die keyboard register during each VBL interrupt If a key is pending, the 
task will dispatch to the KeyBoard interrupt handler via the keyboard 
interrupt vector (as installed by the tool 'SETVECTOR'). Since the 
HeartBeat handler will be installed into the VBL interrupt vector, this 
precludes the application from ins tallin g it's own VBL interrupt handler if 
keyboard interrupts are to be used. If keyboard interrupts are disabled, the 
keyboard task is removed from the HeartBeat queue, however the VBL 
interrupt will not be disabled. If the application wishes to disable keyboard 
interrupts, and does not wish to have the additional overhead of the VBL 
interrupts running in the background, the application must disable VBL 
interrupts also. If no other tasks have been installed into the HeartBeat 
queue, the additional interrupt overhead is minimal (Interrupt dispatcher and 
HeartBeat interrupt handler which only increments the tick count before 
returning). 
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Firmware Entry Tools. This tool allows the Apple] [ emulation mode entry points to be 
supported from full native mode. This tool will preserve the state of the data bank and direct page 
registers prior to dispatching to the firmware entry point During the execution of the firmware 
task, the data bank and direct page registers are set to a value of zero. The data bank and direct 
page registers are restored on return from the firmware entry point 


FWentry 

Input 

Input 

Input 

Input 

Input 

Input 

Input 

Input 

Sp“™ > 


Output 

Output 

Output 

Output 

sp—> 


Function number ® $24 

Word Space for result 

Word Space for result 

Word Space for result 

Word Space for result 

Word Accumulator at entry (low byte only) 

Word X Register at entry (low byte only) 

Word Y Register at entry (low byte only) 

Word Emulation mode entry point (16 bits) 


Word Processor status at exit (low byte only) 

Word Accumulator at exit (low byte only) 

Word X register at exit (low byte only) 

Word Y registo’ at exit (low byte only) 


This call dispatches to the specified emulation mode entry point with the 
registers set to the values passed to the tool as input On return, the register 
contents resulting from the entry point dispatch will be passed on the stack. 
Note that only the least significant byte is relevant on the register input and 
output 


Example: 


PEA 

$0000 

SPACE FOR RESULT 

PEA 

$0000 

SPACE FOR RESULT 

PEA 

$0000 

SPACE FOR RESULT 

PEA 

$0000 

SPACE FOR RESULT 

PEA 

$0000 

A REG 

PEA 

$0000 

X REG 

PEA 

$0000 

YREG 

PEA 

.FWENTRY 

$FDDA 

ENTRY POINT 

BCS 

FWERR ; BRANCH IF ERROR 

PLY 

; GET FW REGISTERS 

PLX 



PLA 



PLP 



PLP 
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Tick Count Tool. This tool allows caller to read the current value of the tick counter. 


GetTick 

Function number = $25 

Input 

LongWord 

Space for result 




Output 

LongWord 

Current value of Tick Counter 

sp—> 




Note that the tick count is only incremented by the heartbeat interrupt 
handler. This means that the heartbeat interrupt handler must be installed, 
and VBL interrupts must be enabled in order to get an incrementing tick 
count. Please see the section on heartbeat tasks. 

Example: 

PEA $0000 ; SPACE FOR RESULT 

PEA $0000 ; SPACE FOR RESULT 

JjETTJCK 
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PackBytes and UnPackBytes Tools. PackBytes and UnPackBytes provide for the packing 
and unpacking of any data, but is ususally used for graphic images. 


PackBytes 

Function number - $26 

Input 

Word 

Space for result 

Input 

LongWord 

Pointer to pointer to start of area to be packed 

Input 

LongWord 

Pointer to a word containing size of the area 

Input 

LongWord 

Pointer to start of the ouput buffer area 

Input 

sp—-> 

Word 

Size of the output buffer area 

Output 

sp—> 

Word 

Number of packed bytes generated 


Upon completion of the call, the pointer to the area to be packed is moved 
forward to the next packable byte, and the size of area pointed to by the 
second input parameter is reduced by the number of bytes traversed. An 
assembly language example follows: 


$ 

* PACKBYTES example: Pick a sonwa image md wit® it to fH® T 
© 


PB 

START 




kk 

#$7BOO 

;m§ of mm to p@ek 


m 

fteS'im 



kk 

#$E12000 

;nddr of sow image 


m 

PfcPtr 



kk 

#$*£12000 

- 


Stfi 

PicPtr+2 



kk 

#buffer 

^joimerto loca buffer 


SCA 

BufPtr 



kk 

#*Buffer 



sm 

BufPtr+2 


loop 

PUSHWORD 

m 

;Space for result 


FUSHLONG 

PicPir 

;Pomtor to data to p&ck 


PUSHLQNG 

#Pic5izs 

JPaitmt to word with size of mm 


FUSHLONG 

BufPtr 

pointer to start of output mm 


PUSHWORD 

BufSizs 

;si m of output buffer mm 


^PACKBYTES 




pk 


;§©£ howstmdt we did p mk this pass 


m 

HowMueh 



CALL 

WHJTEfLBufPtrJiowMuch) ; do I/O to writ® "HowMush" bytes from ' 


Ida 

KeSias 

if more to pack; 


b m 

loop 

;thw is, go b®ek for mom 


m 



PicPir 

ds 

4 

;m to $€12000 cm entry (serein area) 

PieSks 

ds 

2 

\&im of a picture: mi to S7d00 on entry 

BufPtr 

ds 

4 

to point to "Buffer* on eney 

BufSize 

de 

a%40(r 

;loe&i buffo* for storing packed stuff 

HowMuch 

ds 

2 

Joe&I storage for value from packbytes 

Buffer 

ds 

$400 

.actual buffo* 


END 
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An equivalent example in PASCAL follows: 


« 

Function packbytes ( VAR 

VAR 

bufptr 

bvfsize 

: INTEGER; EXTERNAL; 


pkptr : POINTER; 

picsize : POINTER; 

: POINTER; 

: POINTER; 


e 

picsize$7D00; 

bufsize$400; {note: if large enough, could require bus one call} 
REPEAT 

howmuch := PackBytes (picptr,picsizej}ufptrfnrfsize); 
write (f,bufptr,howmuch); 

UNTIL picsize~0 
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UnPackBytes Function number = $27 


Input 

Word 

Space for result 

Input 

LongWord 

Pointer to the buffer containing packed data 

Input 

Word 

Buffer size 

Input 

LongWord 

Pointer to pointer to area to unpack data into 

Input 

LongWord 

Pointer to word containing the size of the area 



to contain the unpacked data 

Output 

sp—> 

Word 

Number of bytes unpacked 


Upon completion, the pointer to the unpacked data is positioned one past the 
last upacked byte and the size fo the area is reduced by the amount 
unpacked. An assembly language example follows: 


$ 

* UNPACKBYTES example: UnPack a file V onto to semen 


PB 

START 




m 

Mark 

; mafic k to fik mark we position to 


kk 

#$7D00 

3 k© of mm to uap®&k into 


m 

Kc Sim 



Ida 

#$112000 

;addr of smm intake 


sta 

PicPtr 



kk 

#$*112000 



sta 

PicPfi^2 


loop 

CALL 

SETHLEMARK(LMisk) 

position file "f to position "Mafic" 


CALL 

READ(LBufPtrBufSi^s) 

;Re&d BufSize” bytes” into "BufPtr” 


PUSHWORD 

#0 

;Sp®ai for mult 


PUSHLONG 

BufPtr 

;Pointer to start of output area 


PUSHWORD 

bufsiz© 

3 ize of output buffer area 


PUSHLONG 

PicPtr 

pointer to data to pack 


PUSHLONG 

#PicSize 

;P©mter to word with size of area 


^UNPACKBYTES 




pk 


;g@t how much w© did unpack this pass 


ck 


;add to previous mark poe. 


sta 

Murk 



Ida 

picsize 

3 ©© if more to unpaok; 


bsq 

dam 

;thm isn’t, so we're dom 


CALL 

EOF(f) 

;did we get to end of fik (safety check) 


bn© 

kop 

mo, go b®ek for more 

Done 

m 



BufPtr 

dc 

i4Buffer' 

;po inter to buffo* m 

bufsiz© 

de 

L2*$4W 

•jocal buffer for storing picked stuff 

PicPg- 

ds 

4 

3 ei to $©12000 on entry (screm area) 

PicSize 

ds 

2 

3 ize of a picture: ret to $7dQ0 on entry 

Mafic 

ds 

2 

;file mafic position 

Buffer 

ds 

$400 

issm&l buffer 


END 
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An equivalent example in PASCAL follows: 


e 

Function unpackbytes ( bufpar : POINTER 

bufsize : POINTER 
VAR pkptr : POINTER 

VAR pksize : POINTER 

: INTEGER; EXTERNAL; 


• 

mmk .*= 0; [i.e. start offile} 

picsize$7B00 

bufsize := $400; {note: if large enough, could require bus one call} 

REPEAT 

setfUemarkfmark); 
readlffrufptr,bufsize); 

howmuch ;= UnPackBytes (bufptr£ufsize,picptrpicsize); 
mark := mark+howmuch; 

UNTIL {(picsize ~0) or eofif)); [eoftest in case of bad data} 


The packed data is in the form of 1 byte containing a flag in the first 2 bits 
and a count in the remaining 6 bits, followed by one or more data bytes 
depending on the flags. Their description is as follows: 

OOXXXXXX : (XXXXXX : 0 -> 63) = 1 to 64 bytes follow - unique 

01XXXXXX : (XXXXXX : 2,4,5 or 6) = 3,5,6 or 7 repeats of next byte 

10XXXXXX : (XXXXXX : 0 -> 63) * 1 to 64 repeats of next 4 bytes 

11XXXXXX : (XXXXXX : 0 -> 63) - 1 to 64 repeates of next 1 byte 

taken as 4 bytes (as in TO’ case) 
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Munger. Munger lets you manipulate bytes in a string of bytes. The basic operation is that of 
searching a destination string for a target string and if found, replacing it with a replacement string. 
The end of the destination string, if the string is shortened, is padded with a pad character. If the 
string is elongated. Characters are truncated off of the end Special cases to allow various other 
functions are defined below. 


Munger Function number = $28 


Input 

Word 

Input 

LongWord 

Input 

LongWord 

Input 

LongWord 

Input 

Word 

Input 

LongWord 

Input 

Word 

Input 

LongWord 

sp—> 


Output 

Word 

sp—> 



Space for result 
Pointer (destptr) 
Point®’ (destlen) 
Points’ (targptr) 
Integer (targlen) 
Pointer (replpff) 
Integer (repllen) 
Pointer (pad) 


Amount of Pad / Truncations 


Where input is: 

destptn Pointer to pointer to the text to be manipulated 

destlen: Pointer to number of bytes to manipulate 

targptr Pointer to string to be searched for from destptr 

targlen: Number of bytes for targptr 

replpff: Pointer to string to replace when targptr found 

repllen: Number of bytes for replpff 

pad: Character value to pad shortened input with 

And output is: 

destptn Updated to one past end of any replacement 
destlen: Old value reduced by bytes scanned across 

pad: Number of bytes padded (or truncated) 

Munger Zero if target found, negative if not 

Special cases: 

If targptr is 0, the substring of length targlen is replaced by the replpff string. 

If targlen is 0, replptrs string is inserted at destptr. 

If replpff is 0, destptr is updated to past the end of the match of the targptr string. 

If repllen is 0, (and rcplptr is not) the targptr string is deleted rather than replaced 
(since the replacement string is empty). 

There is one case in which munger performs a replacement even if it doesn't find 
all for the target string. If the destptr string in ints entirety is at the beginning of 
the targptr string, then the destptr string is totally replaced by the replpff string. 
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& 

* MUNGER example : editing a line of text 

a 

* Changes "robm irwin eagle torinmga rnareia houdini berm" 
0 into "robm irwin EAGLE tonmgm mroi hsudim bems" 


MG 

START 




Ida 


\mi pointer to name 


Stt 

DeitPtr 



Ida 

WlfM 



sta 

DestPaH»2 



Ida 

#41 




DwfLm 



HJSHWORD 

#0 

ispmm for result 


PUSHLOW 

DwtPtr 

;pomtgr to toctstrmg to mmipuks© 


PUSHLONG 

#DestLm 

•JPointar to word with number bytes to change 


PUSHLONG 

#eagkLC 

^Points to M eagle" (lower cm®) 


PUSHWORD 

#3 

;*eagk” has 5 tom 


PUSHLONG 

taigMJC 

iPmmmt to "EAGLE” (uppsr we) 


PUSHWORD 

#3 

; "EAGLE” h m 5 tom 


PUSHLONG 

#PAD 

iPad ehw (don't cm for this example) 


JtfUNGER 




pk 


^TWS WILL BE ZERO, AS WILL PAD] 


rts 



DestPtr 

da 

2 

;oa entry, will point to name 

DestLen 

ds 

2 

;on entry will b@ set to "NLen" 

PAD 

ds 

2 

;ptd value 

eagleLC 

dc 

e'eagle' 


eaglaUC 

do 

cEAGLE 


name 

dc 

e'ratat irwin eagle tomaga mroahoudini bsmi 1 
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An equivalent example in Pascal follows: 


» 

Function monger ( VAR denpir 

POINTER 

VAR destkn 

INTEGER 

tQtgplF 

POINTER 

ffirgkn 

INTEGER 

replptr 

POINTER 

replkn 

INTEGER 

VAR PAD 

INTEGER 

: INTEGER; EXTERNAL; 



{segment to replace a word in Iowa* ease with it's upper ease equivalent) 

name :*» 'robert irwin eagle toranoga marcia houdini bans’; 

/:= LEN (name); 

i := nmngeriname, I,'eagle',5,'EAGLE'J,p); 

{upon completion, i is 0, p is 0, and name is 'robert irwin EAGLE 
toranaga marcia houdini hems'} 


Interrupt Enable State Tool. This function returns with the state of hardware interrupt enable 
states for interrupt sources that can be controlled by the miscellaneous tool set 

GetlRQenbl Function number = $29 

Input Word Space for result 

sp—> 

Output Word S tarns of hardware interrupt enables 

sp—> 


Status in returned word is defined below: 


D8-15 Undefined 

D7 1 Keyboard interrupts enabled 

D6 Is Vertical blanking interrupts enabled 

DS Is Quarto’ second interrupts enabled 

D4 1 = One second interrupts enabled 

D3 Reserved 

D2 1 ® Front Desk Bus data interrupts enabled 

D1 Is Scan line interrupts enabled 

DO 1 = External VGC interrupts enabled 


Example: 

PEA $0000 ; SPACE FOR RESULT 

„GETTR.QENBL 
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SetAbsQamp Function number = $2A 


sp—> 


Input 

Input 

Input 

Input 


Word 

Word 

Word 

Word 


X axis minimum clamp value 
X axis maximum clamp value 

Y axis minimum clamp value 

Y axis maximum damp value 


Sets the clamp values for absolute devices to new values. 


Example: 


PEA $0000 

PEA S03FF 

PEA $0000 

PEA $03FF 

_SETABSCLAMP 


X MINIMUM CLAMP 
X MAXIMUM CLAMP 

Y MINIMUM CLAMP 

Y MAXIMUM CLAMP 


GetAbsQamp Function number = $233 


sp—> 


sp—> 


Input 

Word 

Space for result 

Input 

Word 

Space for result 

Input 

Word 

Space for result 

Input 

Word 

Space for result 

Output 

Word 

X axis minimum clamp value 

Output 

Word 

X axis maximum clamp value 

Output 

Word 

Y axis minimum clamp value 

Output 

Word 

Y axis maximum clamp value 

Returns the 

current values of the absolute device clamps. 

Example: 




PEA $0000 

PEA $0000 

PEA $0000 

PEA $0000 

J3ETAB SCLAMP 


; SPACE FOR RESULT 
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$0000 No Error 

$0301 Bad Input Parameter 

$0302 No Device for Input Parameter 

$0303 Task is already in Heartbeat queue 

$0304 No signature in task header was detected during insert or delete 

$0305 Damaged queue was detected during insert or delete 

$0306 Task was not found during delete 

$0307 Firmware task was unsuccessful 

$0308 Detected damaged HeartBeat Queue 

$0309 Attempted dispatch to a device that is not connected 

$030A Undefined 

S030B ID tag not available 
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Eunction Number 

Dsssdbbqii 

$01 

1 

MTBoodnit 

$02 

2 

MTStartUp 

$03 

3 

MTShutDown 

$04 

4 

MTVersion 

$05 

5 

MTReset 

$06 

6 

MTS tarns 

$07 

7 

MTSparel 

$08 

8 

MTSpare2 

$09 

9 

WriteB Ram 

$0A 

10 

ReadB Ram 

SOB 

11 

WriteBParam 

$0C 

12 

ReadBParam 

SOD 

13 

ReadTimeHex 

$0E 

14 

WriteHmeHex 

$0F 

15 

ReadAsdiTlme 

$10 

16 

SetVector' 

$11 

17 

GetVector 

$12 

18 

SetHeartBeat 

$13 

19 

DelHeartBeat 

$14 

20 

GrHeartBeat 

$15 

21 

SysDeathMgr 

$16 

22 

GetAddr 

$17 

23 

ReadMouse 

$18 

24 

InitMouse 

$19 

25 

SetMouse 

$1A 

26 

HomeMouse 

$1B 

27 

ClearMouse 

$1C 

28 

QampMouse 

$1D 

29 

GetMouseQamp 

$1E 

30 

PosMouse 

$1F 

31 

ServeMouse 

$20 

32 

GetNewID 

$21 

33 

DeletelD 

$22 

34 

StatnsID 

$23 

35 

IntSource 

$24 

36 

FWenffy 

$25 

37 

GetTick 

$26 

38 

PackBytes 

$27 

39 

UnPackBytes . 

$28 

40 

Munger 

$29 

41 

GetlRQenbl 

$2A 

42 

SetAbsQamp 

S2B 43 

ERROR CODES 

GetAbsClamp 
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